home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / futils / futils~1 / man / manpages.zoo / join.1 < prev    next >
Encoding:
Text File  |  1991-11-11  |  2.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. JOIN(1L)                                                 JOIN(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      join - join lines of two files on a common field
  10.  
  11. SYNOPSIS
  12.      join [-a 1|2] [-v 1|2] [-e empty-string] [-o field-list...]
  13.      [-t char] [-j[1|2] field] [-1 field] [-2 field] file1 file2
  14.  
  15. DESCRIPTION
  16.      This manual page documents the GNU version of join.  join
  17.      prints to the standard output a line for each pair of input
  18.      lines, one each from _✓f_✓i_✓l_✓e_✓1 and _✓f_✓i_✓l_✓e_✓2, that have identical
  19.      join fields.  Either filename (but not both) can be `-',
  20.      meaning the standard input.  _✓f_✓i_✓l_✓e_✓1 and _✓f_✓i_✓l_✓e_✓2 should be
  21.      already sorted in increasing order (not numerically) on the
  22.      join fields; unless the -_✓t option is given, they should be
  23.      sorted ignoring blanks at the start of the line, as sort
  24.      does when given the -_✓b option.
  25.  
  26.      The defaults are: the join field is the first field in each
  27.      line; fields in the input are separated by one or more
  28.      blanks, with leading blanks on the line ignored; fields in
  29.      the output are separated by a space; each output line con-
  30.      sists of the join field, the remaining fields from _✓f_✓i_✓l_✓e_✓1,
  31.      then the remaining fields from _✓f_✓i_✓l_✓e_✓2.
  32.  
  33.      OPTIONS
  34.  
  35.      -_✓a _✓f_✓i_✓l_✓e-_✓n_✓u_✓m_✓b_✓e_✓r
  36.           Print a line for each unpairable line in file _✓f_✓i_✓l_✓e-
  37.           _✓n_✓u_✓m_✓b_✓e_✓r (either 1 or 2), in addition to the normal out-
  38.           put.
  39.  
  40.      -_✓e _✓s_✓t_✓r_✓i_✓n_✓g
  41.           Replace empty output fields (those that are missing in
  42.           the input) with _✓s_✓t_✓r_✓i_✓n_✓g.
  43.  
  44.      -_✓1, -_✓j_✓1 _✓f_✓i_✓e_✓l_✓d
  45.           Join on field _✓f_✓i_✓e_✓l_✓d (a positive integer) of file 1.
  46.  
  47.      -_✓2, -_✓j_✓2 _✓f_✓i_✓e_✓l_✓d
  48.           Join on field _✓f_✓i_✓e_✓l_✓d (a positive integer) of file 2.
  49.  
  50.      -_✓j _✓f_✓i_✓e_✓l_✓d
  51.           Equivalent to -_✓1 _✓f_✓i_✓e_✓l_✓d -_✓2 _✓f_✓i_✓e_✓l_✓d.
  52.  
  53.      -_✓o _✓f_✓i_✓e_✓l_✓d-_✓l_✓i_✓s_✓t...
  54.           Construct each output line according to the format in
  55.           _✓f_✓i_✓e_✓l_✓d-_✓l_✓i_✓s_✓t.  Each element in _✓f_✓i_✓e_✓l_✓d-_✓l_✓i_✓s_✓t consists of a
  56.           file number (either 1 or 2), a period, and a field
  57.           number (a positive integer).  The elements in the list
  58.           are separated by commas or blanks.  Multiple _✓f_✓i_✓e_✓l_✓d-_✓l_✓i_✓s_✓t
  59.           arguments can be given after a single -_✓o option; the
  60.  
  61.  
  62.  
  63. Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JOIN(1L)                                                 JOIN(1L)
  71.  
  72.  
  73.  
  74.           values of all lists given with -_✓o are concatenated
  75.           together.
  76.  
  77.      -_✓t _✓c_✓h_✓a_✓r
  78.           Use character _✓c_✓h_✓a_✓r as the input and output field
  79.           separator.
  80.  
  81.      -_✓v _✓f_✓i_✓l_✓e-_✓n_✓u_✓m_✓b_✓e_✓r
  82.           Print a line for each unpairable line in file _✓f_✓i_✓l_✓e-
  83.           _✓n_✓u_✓m_✓b_✓e_✓r (either 1 or 2), instead of the normal output.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Page 2
  130.  
  131.  
  132.  
  133.